addvdiskaccess
addvdiskaccess コマンドは、ホストに対してボリュームへのアクセスを可能にすることができる入出力グループのセットに、入出力グループ (複数可) を追加するために使用します。
構文
パラメーター
- -iogrp iogrp_id_list | iogrp_name_list
- (必須) 入出力グループのボリューム・アクセス・セットに追加する入出力グループのリストを指定します。
- -allowmismatchedscsiids
- (オプション)新しいアクセス入出力グループを追加する場合、このパラメーターにより、SCSI LUN ID を既存のアクセス入出力グループで現在割り当てられている SCSI LUN ID と異なるものにすることができます。
- vdisk_id | vdisk_name
- (必須) 指定した入出力グループを介したアクセスを追加する対象のボリュームを指定します。
説明
入出力グループが既にアクセス・セットのメンバーである場合、エラーは生成されません。また、その入出力グループに対して実行されるアクションはありません。ボリュームに関するすべてのホスト・マッピングが、リスト内の入出力グループに追加されます。追加マッピングを他の入出力グループに拡張する場合、-force オプションは不要です。
入出力グループがアクセス・セットに追加されると、ホストからボリュームへのアクセスが作成されます。このホストは、入出力グループ内のノードからボリュームにマップされます。ボリュームが 2 回マップされると、そのボリュームはすべての追加入出力グループにも 2 回マップされます。
入出力グループが iSCSI ホストへマップされている場合、それらの入出力グループをボリューム・アクセス・リストに追加できます。つまり、iSCSI ホストは、複数の入出力グループ (および単一の入出力グループ) を介してアクセスできるボリュームにアクセスすることができます。
- (ボリュームがホスト・マッピングを持っている) どのホストもリスト内の入出力グループに関連付けられていない。
- ホスト・ボリューム・マッピングの制限を超過している。
- 追加されたマッピングの数が、ホスト・ボリューム・マッピングのクラスター化システムの制限を超過している。
- 新規アクセス入出力グループで同じ SCSI LUN ID を使用できない。
- 単一の入出力グループ内の 512 個のボリュームにマップする
- 2 つの入出力グループにまたがる 256 個のボリュームにマップする
- 4 つの入出力グループにまたがる 64 個のボリュームにマップする
ボリュームにマップ されているホストのいずれかが、複数の入出力グループからマップされているボリュームをサポートしないホスト・システムとして検出された場合、このコマンドは失敗します。
他のアクセス入出力グループのボリュームに割り振られているのと同じ SCSI LUN ID を新規アクセス入出力グループで使用できる場合、システムはその ID を割り当てます。-allowmismatchedscsiids パラメーターを使用すると、システムは、アクセス入出力グループで同一でない SCSI LUN ID を割り振ることができます。各アクセス入出力グループで使用できる最も低い値が使用されます。すべてのアクセス入出力グループで同じにならない場合があります。ホストがこの構成をサポートしていることを確認してください。このパラメーターは、NVMe ホストではサポートされていません。NVMe プロトコルを使用するホストにボリュームがマップされると、システムによってボリューム名前空間 ID (NSID) が割り当てられます。既存のアクセス入出力グループで別の SCSI LUN ID が既に割り当てられているボリュームへのアクセス権限を追加するときは、-allowmismatchedscsiids を使用する必要があります。そうしないと、コマンドは失敗します。
呼び出し例
以下の例では、入出力グループ 2 を DB_Volume のボリューム・アクセス・セットに追加します。
addvdiskaccess -iogrp 2 DB_Volume結果出力:
No feedback
呼び出し例
以下の例では、入出力グループ 2 および 3 をボリューム ID 3 のボリューム・アクセス・セットに追加します。
addvdiskaccess -iogrp 2:3 3結果出力:
No feedback